home *** CD-ROM | disk | FTP | other *** search
/ Aminet 7 / Aminet 7 - August 1995.iso / Aminet / util / time / NISClock171.readme < prev    next >
Text File  |  1995-07-02  |  9KB  |  203 lines
  1. Short:    Many Options. Vanishes for Prefs change.
  2. Author:   John D. Muir <John_Muir@UManitoba.Ca>
  3. Uploader: John D. Muir <John_Muir@UManitoba.Ca>
  4. Type:     util/time
  5.  
  6.  
  7.                           NISClock 1.71 (7.6.95)
  8.                         © Copyright 1995 John Muir
  9.                            Written by John Muir
  10.  
  11. ___________________________________________________________________________
  12. Introduction
  13.  
  14. NISClock is a small clock program that uses a minimum amount of CPU time
  15. since it only updates the clock every minute (or every second if you
  16. wish).
  17.  
  18. It can make use of Stephan Becker's screennotify.library which patches a
  19. few intuition.library functions so that the clock will automatically close
  20. its window if the Public screen that it inhabits is closed by another
  21. program.  If NISClock is on the Workbench screen, it will be notified of
  22. the close and opening of the Workbench screen by IPrefs for a preferences
  23. change or by any other program which calls CloseWorkbench().  The window
  24. will then not open until OpenWorkbench() is called.
  25.  
  26. The tooltypes can be used to customize the position, and look of the
  27. NISClock window to a certain extent.  Other features include optional
  28. seconds, 24-hour mode, and three output formats for the date.  A single
  29. mouse click will cause the date to be displayed, or both the date and the
  30. time can be displayed at the same time.
  31.  
  32. ___________________________________________________________________________
  33. Requirements
  34.  
  35. - Amiga OS V37 (2.04) or greater.  Uses V39 features if present.
  36. - Optionally: screennotify.library by Stephan Becker.  See 'Installation'
  37.  for more information on screennotify.library.
  38. - NISClock must be run from the Workbench.
  39.  
  40. ___________________________________________________________________________
  41. Installation
  42.  
  43. Use the Workbench to copy NISClock into the WBStartup drawer to have the
  44. program execute as you startup.  If you have a 68020 or better, use the
  45. CLI to delete NISClock, and rename NISClock_020 as NISClock before copying
  46. it.
  47.  
  48. If you decide to use screennotify.library by Stephan Becker for the
  49. enhanced features, the library must be installed in LIBS: or PROGDIR: (the
  50. directory where NISClock is started from).  Get screennofity.library from
  51. the distribution archive on AmiNET:
  52.  
  53. /pub/aminet/util/libs/ScreenNotify10.lha
  54.  
  55. screennotify.library is also available in the latest ToolManager
  56. distribution archive(s) which I recommend highly;
  57.  
  58. /pub/aminet/util/boot/ToolManager21?.lha
  59.  
  60. ___________________________________________________________________________
  61. Usage
  62.  
  63. NISClock will only run from the Workbench and it supports the following
  64. tooltypes;
  65.  
  66.   SECONDS - Boolean; true when the tooltype exists.
  67.        - display seconds when true.
  68.  
  69.   24HOUR - Boolean
  70.        - display the time in 24 hour mode.
  71.  
  72.   INTITLEBAR - Boolean
  73.        - display the time in the title bar colours, otherwise a box
  74.         is drawn on the edge of the window to match the depth gadget.
  75.        - NOTE: V37: Backpen = 2 (White) and FrontPen = 1 (Black).
  76.  
  77.   FULLYEAR - Boolean
  78.        - display the year part as YYYY.
  79.  
  80.   TIMEDATE - Boolean
  81.        - display the date and time at the same time.
  82.  
  83.   LEFTEDGE - Numeric; eg: LEFTEDGE=400
  84.        - the value represents the left edge of the NISClock window.
  85.        - -1 for default position.
  86.        - the window cannot be positioned with the mouse, so make good use
  87.         of the file notificaiton on NISClock.info! :)
  88.  
  89.   DATEFORMAT - Enumerated; eg: DATEFORMAT=DDMMYY
  90.        - display the date in the requested format;
  91.         DATEFORMAT = DDMMYY (default), MMDDYY or YYMMDD.
  92.  
  93.   JUSTIFICATION - Enumerated
  94.        - display the time and/or date with justification;
  95.         JUSTIFICATION = CENTER, RIGHT, LEFT, or NONE.
  96.        - NONE means RIGHT when INTITLEBAR is true, and CENTER otherwise.
  97.  
  98. NISClock will automatically update itself if the icon tooltypes are
  99. changed.
  100.  
  101. A mouse click on the NISClock window will cause the date to be displayed
  102. unless TIMEDATE is true.  Additional Clicking will toggle between Time and
  103. Date.  The Time will automatically reappear after 4 seconds.
  104.  
  105. To QUIT NISClock, simply run the program again.
  106.  
  107. NISClock WILL NOT RUN from the CLI.
  108.  
  109. ___________________________________________________________________________
  110. Comments? Talk to me!
  111.  
  112. EMail:     John D. Muir <John_Muir@UManitoba.Ca>
  113.     or     John Derek Muir <ummuir05@cc.umanitoba.ca>
  114.  
  115. Snail Mail:
  116.     John Muir
  117.     3-152 Guigues Ave.
  118.     Ottawa, ON
  119.     K1N 5H9
  120.     CANADA
  121.  
  122. ___________________________________________________________________________
  123. History
  124.  
  125. 0.99   - Released to IRC for testing.  Tested on OS2.x and OS3.x.
  126. 1.0    - Released to AmiNET. 68000 version compiled... (oops! :)
  127. 1.1    - Now displays the date with a mouse click on the Window.
  128.        - Date disappears after 5 seconds.
  129.        - Fixed a few bugs.
  130. 1.2    - Reduced Code Size.
  131.        - Date disappears after 4 seconds now.
  132.        - Date is displayed in standard DD.MM.YY, 0s removed.
  133. 1.2a   - BUGFIX: 10 o'clock now shows the 1...
  134. 1.3    - Added the tooltypes; SECONDS, 24HOUR, INTITLEBAR
  135.        - INTITLEBAR requires intuition.library >= V39.
  136. 1.4    - Added the DATEFORMAT tooltype.  See "Usage" for more.
  137.        - INTITLEBAR no longer requires V39.  Pens 1 and 2 are used as
  138.         foreground and background respectively.
  139. 1.5    - JUSTIFICATION tooltype added. (NONE, LEFT, RIGHT, or CENTER)
  140.         RIGHT is the default for INTITLBAR=1, while CENTER is the default
  141.         for INTITLEBAR=0.
  142.        - FULLYEAR causes YYYY to be displayed instead of YY.
  143.        - TIMEDATE causes the time and the date to be displayed at the same
  144.         time.
  145.        - 68030 Compilation included.
  146.        - The icon is a NewIcons icon. Thanks to Gavin Hamil.
  147. 1.51   - Small Code optimizations -> 76 byte reduction.
  148. 1.60   - Oops... I forgot that the revision number is not decimal..
  149.        - You can now position the window using the LEFTEDGE tooltype.
  150.        - Reworked the USAGE section of the .readme file.
  151.        - Including an '020 compilation instead of '030 since they are the
  152.         same size.
  153. 1.61   - Size optimizations.  '020 version is now under 4k!!
  154. 1.62   - BUGFIX: Now the program does not try to reopen its window 5
  155.         seconds after being notified of a Closed Workbench.  Although
  156.         NISClock opens on the Default public screen, it is a good idea to
  157.         make it run on the Workbench screen, because otherwise it may
  158.         cause problems with other programs such as Directory Opus.  Maybe
  159.         I'll implement opening on a PUBSCREEN of choice..
  160.        - BUGFIX: ToolTypes can now be turned off with icon notification
  161.         after the program has been running. (Notification worked, but you
  162.         couldn't turn off the options... ;)
  163.        - Size optimizations.  Lost 112 bytes (116 for '020 version).
  164. 1.70   - No longer requires screennotify.library.
  165.        - BUGFIX: Defaults for JUSTIFICATION and DATEFMT are now set
  166.         properly if the tooltypes aren't found.
  167.        - Handles other public screens properly should you manage to get
  168.         NISClock on a screen besides Workbench. ie; NISClock will close
  169.         its window if the Public Screen is closed.  Provided you are using
  170.         screennotify.library of course.
  171.        - Two spaces between Date and Time when TIMEDATE is set.
  172.        - WARNING: Do not use screennotify.library and ScreenTab at the
  173.         same time if you have windows that subscribe to
  174.         screennotify.library (NISClock) on OTHER public screens (besides
  175.         Workbench) or intuition will Dead-Lock.
  176. 1.71   - Code optimizations.
  177.        - Version string now says NISClock_020 for the '020 version.
  178.        - Rewrote some parts of this text.
  179.        - BUGFIX: Now always RectFill()s over parts of the window that are
  180.         not written to.  Sometimes some characters would not be completely
  181.         removed when a new (shorter) time was written to the window.
  182.  
  183. ___________________________________________________________________________
  184. To Do - Let me know if you have a favorite or suggestions.
  185.  
  186.        - PUBSCREEN of your choice. (maybe)
  187.        - Localization; time and date are displayed in the format specified
  188.         by your locale.  (v2.0)
  189.        - The weekday written. <- localized.  (v2.0)
  190.        - The month written. <- localized.  (v2.0)
  191.  
  192.  
  193. ============================= Archive contents =============================
  194.  
  195. Original  Packed Ratio    Date     Time    Name
  196. -------- ------- ----- --------- --------  -------------
  197.     4420    2791 36.8% 07-Jun-95 17:15:24  NISClock
  198.     4196    2633 37.2% 07-Jun-95 17:14:00  NISClock_020
  199.     5315    2118 60.1% 07-Jun-95 17:04:08  NISClock.info
  200.     8232    3303 59.8% 08-Jun-95 19:07:34  NISClock.readme
  201. -------- ------- ----- --------- --------
  202.    22163   10845 51.0% 09-Jun-95 12:10:56   4 files
  203.